home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / cnet / colorutils.lha / ColorUtils.README! < prev   
Text File  |  1995-10-07  |  15KB  |  441 lines
  1. ============================================================================
  2.        CNet Amiga MCI Color Utilities, v1.2 by Dotoran of Frontiers!
  3. ============================================================================
  4.  
  5.     Hey there everybody! What's up?!? Got another utility program for ya!
  6. This program is the programmers or customizers dream when dealing with MCI
  7. Color codes.
  8.  
  9.     Included within this one file are TEN(10) modules/utilities that will
  10. allow you to do the following to any TEXT file or ARexx PFILE (Standard, not
  11. Compiled) in a matter of seconds:
  12.  
  13.     - Change old style Slash Commands to new style Control-Y Commands.
  14.  
  15.     - Change from the old MCI color order to the new MCI color order.
  16.  
  17.     - Change from Control-Y MCI Codes to Control-Q MCI Codes.
  18.  
  19.     - Change from Control-Q MCI Codes to Control-Y MCI Codes.
  20.  
  21.     - Convert to using ONLY the HIGH INTENSITY MCI Colors(2nd Eight).
  22.  
  23.     - Convert to using ONLY the LOW  INTENSITY MCI Colors(1st Eight).
  24.  
  25.     - Change 2nd eight into 1st eight, and 1st eight into 2nd eight.
  26.  
  27.     - Change one or more MCI Colors to other MCI Colors.
  28.  
  29.     - Swap two or more MCI Colors within a file.
  30.  
  31.     - Strip ALL 3 character Control-Y MCI codes from a file.
  32.  
  33. NOTE: To convert ALL old style "slash" MCI codes, use Ken Pletzer's UP250
  34.       program. See the BOTTOM of this document for more information on how
  35.       to use this file.
  36.  
  37.     As you can see, there's a veritable smorgasborg of great utilities all
  38. within this one program.
  39.  
  40.     To install this file, simply follow these steps:
  41.  
  42. 1: Place "ColorUtils" in your "PFILES:MAINTENANCE/" directory.
  43.  
  44. 2: Add it as a SysOp Only ARexx Pfile.
  45.  
  46. 3: If you wish, you can create the "COL" SysOp Only command by adding this
  47.    line to the end of Menu # 1 (Maintenance Menu) of BBSMENU:
  48.  
  49.     COL, COLor  |   {#0 pfiles:maintenance/ColorUtils}
  50.                     ^
  51.                 Control-Q
  52.  
  53. 4: That's it, you're done!
  54.  
  55.     You can do everything you need to do from one screen in this program.
  56. This program was written to use LOTS of COLOR, IBM GRAPHICS, and ANSI CODES,
  57. so will most probably want to be run in local mode, although it CAN be used
  58. from remote, with a slight decrease in speed.
  59.  
  60.     You can traverse through the three menus in two ways:
  61.  
  62.         - Use the four CURSOR keys. (LEFT/RIGHT/UP/DOWN)
  63.  
  64.         - Press the UNDERLINED Letter of the Command.
  65.  
  66.     Either method will HIGHLIGHT the needed function, but you will need to
  67. press RETURN/ENTER to SELECT the function.
  68.  
  69.  NEW: Something NEW in v1.2 over v1.0 is the ability to enter a PATH ALONE
  70. v1.2: in the "path to convert" string gadget. Doing so will allow you to
  71.     : convert ALL files located within that path using the settings you
  72.     : specified earlier for ALL files. To make this fully automatic, make
  73.     : sure to also specify to view NEITHER before or after. This way, one
  74.     : file after another will be immediately converted, with no waiting,
  75.     : and no further input needed from you.
  76.  
  77.     For the two PATH/FILE string gadgets, you can use the following CONTROL
  78. CODES to help you edit text:
  79.  
  80.         - Control X     -   Delete ALL contents in gadget.
  81.  
  82.         - Control B     -   Move to BEGINNING of text.
  83.  
  84.         - Control N     -   Move to END of text.
  85.  
  86.         - BACKSPACE     -   Delete ONE character.
  87.  
  88.         - DELETE Key    -   PULL one character INTO the cursor.
  89.  
  90.  
  91.     The SAVE path/file will DEFAULT to the one entered for LOAD, but you can
  92. change this to suit your needs. If you select a SAVE path/file that EXISTS
  93. in your system, you'll be asked if you wish it to be overwritten.
  94.  
  95.     There are two text windows at the BOTTOM of the screen that you will want
  96. to be aware of:
  97.  
  98.     INFO Window:
  99.  
  100.         - This is the ONE LINE window where prompt text will be displayed.
  101.  
  102.         - As a rule, check here first if you're not sure what to do next.
  103.  
  104.  
  105.     HELP Window:
  106.  
  107.         - This is the LARGE window at the BOTTOM of the screen.
  108.  
  109.         - Whenever a menu item is selected, you will be shown text here that
  110.           will offer you some additional information as to what that item
  111.           will do for you.
  112.  
  113.         - This window is also used for the COLOR SELECTION box.
  114.  
  115.         - Lastly, while a conversion is in progress, this window will be
  116.           filled with the following information:
  117.  
  118.                 - Reading Line
  119.  
  120.                     - A running total of the lines in the file as they are
  121.                       initially being read into the computer.
  122.  
  123.                 - Total Steps
  124.  
  125.                     - Some of the conversion functions are needed to be done
  126.                       in multiple steps. This tells you the total number of
  127.                       steps that are required for this conversion operation.
  128.  
  129.                 - Working Step
  130.  
  131.                     - Tells you how many MORE steps are needed to be done
  132.                       before the end of the conversion.
  133.  
  134.                 - Working Line
  135.  
  136.                     - Tells you the current line being worked on while the
  137.                       conversion is taking place.
  138.  
  139.                 - Converted Lines
  140.  
  141.                     - This counter tells you how many lines where POSSIBLE
  142.                       conversion has taken place. (In reality, this is the
  143.                       total number of lines found that CONTAIN MCI Color
  144.                       Codes in them).
  145.  
  146.                 - Converted Codes
  147.  
  148.                     - This is a running total of the number of MCI Codes that
  149.                       HAVE been converted. (This is an EXACT count).
  150.  
  151.                 - Writing Lines
  152.  
  153.                     - A running total on the number of lines that have been
  154.                       written to the SAVE file. (This number should MATCH
  155.                       the "Reading Line" value).
  156.  
  157.     That's all there is to using the program. The rest of this document will
  158. go into specific detail as to WHAT each of the ten modules DOES to a file
  159. during it's conversion:
  160.  
  161.         Low 8 to
  162.          High 8
  163.         ~~~~~~~~
  164.             - Total Steps: 1
  165.  
  166.             - File Type Needed: A Control-Y coded file.
  167.  
  168.             - File finds all instances of:
  169.  
  170.                 \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  171.  
  172.             - And converts them to the following, respectively:
  173.  
  174.                 \c8 \c9 \ca \cb \cc \cd \ce \cf
  175.  
  176.             - Note that \ above is a Control-Y character.
  177.  
  178.  
  179.          High 8
  180.         to Low 8
  181.         ~~~~~~~~
  182.             - Total Steps: 1
  183.  
  184.             - File Type Needed: A Control-Y coded file.
  185.  
  186.             - File finds all occurances of:
  187.  
  188.                 \c8 \c9 \ca \cb \cc \cd \ce \cf
  189.  
  190.             - And converts them to the following, respectively:
  191.  
  192.                 \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  193.  
  194.             - Note that \ above is a Control-Y character.
  195.  
  196.  
  197.         High 2 Low
  198.         Low 2 High
  199.         ~~~~~~~~~~
  200.             - Total Steps: 3
  201.  
  202.             - File Type Needed: A Control-Y coded file.
  203.  
  204.             - Step 1:
  205.  
  206.                     - Find these Control-Y codes:
  207.  
  208.                             \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  209.  
  210.                     - Convert these into SLASH Code INTENSE Colors.
  211.  
  212.             - Step 2:
  213.  
  214.                     - Find these Control-Y codes:
  215.  
  216.                             \c8 \c9 \ca \cb \cc \cd \ce \cf
  217.  
  218.                     - Convert these into SLASH Code NORMAL Colors.
  219.  
  220.             - Step 3:
  221.  
  222.                     - Find the following SLASH Codes:
  223.  
  224.                             \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  225.                             \c8 \c9 \ca \cb \cc \cd \ce \cf
  226.  
  227.                     - Convert these into Control-Y equivalents.
  228.  
  229.  
  230.         Control-Y
  231.         Control-Q
  232.         ~~~~~~~~~
  233.             - Total Steps: 1
  234.  
  235.             - File Type Needed: A Control-Y coded file.
  236.  
  237.             - Find these Control-Y Codes:
  238.  
  239.                 \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  240.                 \c8 \c9 \ca \cb \cc \cd \ce \cf
  241.                 \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  242.  
  243.             - Convert these into Control-Q equivalents.
  244.  
  245.  
  246.         Control-Q
  247.         Control-Y
  248.         ~~~~~~~~~
  249.             - Total Steps: 1
  250.  
  251.             - File Type Needed: A Control-Q coded file.
  252.  
  253.             - Find these Control-Q Codes:
  254.  
  255.                 {c0} {c1} {c2} {c3} {c4} {c5} {c6} {c7}
  256.                 {c8} {c9} {ca} {cb} {cc} {cd} {ce} {cf}
  257.                 {z0} {z1} {z2} {z3} {z4} {z5} {z6} {z7}
  258.  
  259.             - Convert these into Control-Y equivalents.
  260.  
  261.  
  262.         Slash to
  263.         Control-Y
  264.         ~~~~~~~~~
  265.             - Total Steps: 1
  266.  
  267.             - File Type Needed: A Slash MCI coded file.
  268.  
  269.             - Find these Slash Codes:
  270.  
  271.                     \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  272.                     \c8 \c9 \ca \cb \cc \cd \ce \cf
  273.                     \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  274.  
  275.             - Convert these into Control-Y equivalents.
  276.  
  277.  
  278.         Old to New
  279.         Code Order
  280.         ~~~~~~~~~~
  281.             - Total Steps: 2
  282.  
  283.             - File Type Needed: A Control-Y coded file.
  284.  
  285.             - Step 1:
  286.  
  287.                     - Find these Control-Y Codes:
  288.  
  289.                             \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  290.                             \c8 \c9 \ca \cb \cc \cd \ce \cf
  291.                             \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  292.  
  293.                     - Convert these to NEW Order SLASH Codes.
  294.  
  295.             - Step 2:
  296.  
  297.                     - Find these Slash MCI Codes:
  298.  
  299.                             \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  300.                             \c8 \c9 \ca \cb \cc \cd \ce \cf
  301.                             \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  302.  
  303.                     - Convert these to Control-Y Codes.
  304.  
  305.  
  306.         MCI Color
  307.          Swapper
  308.         ~~~~~~~~~
  309.             - Total Steps: 2
  310.  
  311.             - File Type Needed: A Control-Y coded file.
  312.  
  313.             - Step 1:
  314.  
  315.                     - Find these Control-Y Codes:
  316.  
  317.                             \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  318.                             \c8 \c9 \ca \cb \cc \cd \ce \cf
  319.                             \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  320.  
  321.                     - Convert these to SLASH Codes, using the
  322.                       custom built conversion string.
  323.  
  324.             - Step 2:
  325.  
  326.                     - Find these Slash MCI Codes:
  327.  
  328.                             \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  329.                             \c8 \c9 \ca \cb \cc \cd \ce \cf
  330.                             \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  331.  
  332.                     - Convert these to Control-Y Codes.
  333.  
  334.  
  335.         MCI Color
  336.          Changer
  337.         ~~~~~~~~~
  338.             - Total Steps: 2
  339.  
  340.             - File Type Needed: A Control-Y coded file.
  341.  
  342.             - Step 1:
  343.  
  344.                     - Find these Control-Y Codes:
  345.  
  346.                             \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  347.                             \c8 \c9 \ca \cb \cc \cd \ce \cf
  348.                             \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  349.  
  350.                     - Convert these to SLASH Codes, using the
  351.                       custom built conversion string.
  352.  
  353.             - Step 2:
  354.  
  355.                     - Find these Slash MCI Codes:
  356.  
  357.                             \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  358.                             \c8 \c9 \ca \cb \cc \cd \ce \cf
  359.                             \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  360.  
  361.                     - Convert these to Control-Y Codes.
  362.  
  363.  
  364.         MCI Code
  365.         Stripper
  366.         ~~~~~~~~
  367.             - Total Steps: 1
  368.  
  369.             - File Type Needed: A Control-Y coded file.
  370.  
  371.             - Find and REMOVE the following Control-Y MCI Codes:
  372.  
  373.                     \c0 \c1 \c2 \c3 \c4 \c5 \c6 \c7
  374.                     \c8 \c9 \ca \cb \cc \cd \ce \cf
  375.                     \z0 \z1 \z2 \z3 \z4 \z5 \z6 \z7
  376.  
  377.             - And these OTHER Control-Y MCI Codes:
  378.  
  379.                     \: \a \b \f \g \h \k \n \o \p \q
  380.                     \r \s \u \w \^ \! \> \< \- \? \=
  381.  
  382.             - Control-Y Codes NOT removed fully are:
  383.  
  384.                     \@ \i \j \l \m \t \v \x \* \# \$ \+ \& \%
  385.  
  386.                     - These codes are generally LONGER than three characters
  387.                       long, which means if you try and MCI Strip a file that
  388.                       contains any of these codes, the entire command will
  389.                       NOT be removed.
  390.  
  391.                     - Because of this, it is suggested that you NOT use this
  392.                       module on LARGE PFILES which MIGHT contain one or more
  393.                       of the above commands.
  394.  
  395. ----------------------------------------------------------------------------
  396.  
  397.     That's it. Hope you enjoy it, and that it can be of use to you. Lastly,
  398. I've been asked by numerous people for a module that converts ALL SLASH-type
  399. MCI Codes into the Control-Y type codes.  A module to do this was NOT housed
  400. in this pfile, because Ken Pletzer himself wrote a program that does this
  401. QUITE nicely(and blindingly fast too!) You'll find it in your "Updates/"
  402. directory of disk # 2 of your CNet Command Set. It's called "UP250". It was
  403. originally written to convert older formatted message base files into the
  404. newer version we were using at that time, however it also contains a utility
  405. to convert old mci codes to the new ones. To use the program, follow these
  406. steps:
  407.  
  408.  1: From a CLI Window, type UP250 from WITHIN the directory that houses it.
  409.     (I use it on a regular basis, so store it directly in my CNET: path)
  410.  
  411.  2: Answer "N" (No) to the first THREE questions it asks you.
  412.  
  413.  3: Answer "Y" (Yes) to the next question that asks if you'd like to convert
  414.     mci's in other files.
  415.  
  416.  4: You can either specify the exact path/filename location of a specific
  417.     file you'd like to convert, or else specify JUST the path, upon which
  418.     it will attempt to convert ALL FILES contained within said path.
  419.  
  420.  5: One note of warning when specifying just the path, though. The program
  421.     makes an attempt to convert ALL INSTANCES of the \ character, whether
  422.     it's part of an MCI code or not. Some ASCII graphic pictures make use of
  423.     the slash as a graphic character, as well as some ARexx programs using
  424.     it in their headers. For instance, my ARexx files use a standard three
  425.     lines which look like these:
  426.  
  427.                 /**************************\
  428.                     $VER: Version String
  429.                 \**************************/
  430.  
  431.     In the above example, the backslash used at the END of the first line,
  432.     as well as the one used at the START of the third line would ALSO be
  433.     converted when using this program. Nothing BAD will happen if a file is
  434.     used where unnecessary conversions are made, however it tends to make a
  435.     file rather tough to read(and could cause a garbled look in graphics
  436.     that use this character).
  437.  
  438.  6: That's all there is to using this other extremely powerful program!
  439.  
  440.                                                                  - Dotoran
  441.